home *** CD-ROM | disk | FTP | other *** search
/ L' Effet Pommier 3 / L'Effet Pommier - Volume 03.iso / Programmation / Tcl⁄Tk Folder / README-mac-tk < prev    next >
Encoding:
Text File  |  1996-02-01  |  6.2 KB  |  184 lines  |  [TEXT/ALFA]
  1. Macintosh Tk
  2.  
  3. by Ray Johnson
  4. Sun Microsystems Laboratories
  5. rjohnson@eng.sun.com
  6.  
  7. @(#) README 1.6 96/01/30 12:49:13
  8.  
  9. 1. Introduction
  10. ---------------
  11.  
  12. This is the README file for the Macintosh version of the Tk
  13. extension for the Tcl scripting language.  The file consists of
  14. information specific to the Macintosh version of Tcl and Tk.  For more
  15. general information please read the README file in the main Tk
  16. directory.
  17.  
  18. 2. Whats new?
  19. -------------
  20.  
  21. See the general Tk README for all the new items in tk4.1.  This
  22. section will only discuss those items which are specific to the
  23. Macintosh.
  24.  
  25. More stable, faster, etc. - A great deal of effort has gone into
  26.     making Tk more stable & useable.  I have yet to really
  27.     focus on speed improvements - but I think you will find
  28.     this version a bit faster than the last release.  Tk still
  29.     fails most of the test suite.  However, it's getting better
  30.     and I swear it will pass someday!
  31.  
  32. Native Console & Scrollbar- The Tk console is still written in Tk.
  33.     However, it now uses the Macintosh Look & Feel.  This was
  34.     achived by using various options on the Text widget and
  35.     implementing a new native scrollbar.  This is the first
  36.     step at our attempt to get all the widgets native for the
  37.     Mac.  You may play around with the new scrollbar in Tk if
  38.     you so desire - the name of the command is "macscrollbar"
  39.     and works the same as the regular scrollbar command.
  40.  
  41. New source menu - The menubar now sports a new "Source..." menu
  42.     item that displays a dialog to find a file to source.
  43.     Several people requested this - so I hope you find it 
  44.     useful!
  45.  
  46. About dialog - There is now a way to replace the default dialog box
  47.     for the Wish application.  If you create the tcl procedure
  48.     "tkAboutDialog" it will be called instead of creating the
  49.     default dialog box.  Your procedure is then responsible for
  50.     displaying a window, removing it, etc.  This interface is
  51.     experimential and may change in the future - tell me what
  52.     you think of it.
  53.  
  54. Most other changes have been under the covers.  Most all reported
  55. bugs have been fixed.  I hope to get a first cut at the native look &
  56. feel for many widgets before the final release.  (The native look &
  57. feel, of course, won't be final.)  The only bug I know I didn't fix is
  58. a bug with displaying certain sized images.  If you knew of a bug that
  59. hasn't been fixed - please report it again.
  60.  
  61. 3. The Distribution
  62. -------------------
  63.  
  64. Macintosh Tk is distributed in two different forms.  This 
  65. should make it easier to only download what you need.  The 
  66. packages are as follows:
  67.  
  68. mactk4.1b1.sea.hqx
  69.  
  70.     This distribution is a "binary" only release.  It contains an
  71.     installer program that will install a 68k, PowerPC, or Fat
  72.     version of the "Wish" application.  In addition, in installs
  73.     the Tcl & Tk libraries in the Extensions folder inside your
  74.     System Folder.  (These are just text files - no inits are
  75.     installed.)
  76.  
  77. mactcltk-full-4.1b1.sea.hqx
  78.  
  79.     This release contains the full release of Tcl and Tk for the
  80.     Macintosh plus the GUSI and More Files packages which both
  81.     Macintosh Tcl and Tk rely on.
  82.  
  83. mactk-source-4.1b1.sea.hqx
  84.  
  85.     This release contains the complete source to Tk for the Macintosh
  86.     In addition, Metrowerks CodeWarrior libraries and project files
  87.     are included.  However, you must already have the More Files and
  88.     GUSI packages to compile this code.
  89.  
  90. 4. Documentation
  91. ----------------
  92.  
  93. Two books are currently available for Tcl.  Both provide a good
  94. introduction to the language.  It is a good way to get started
  95. if you havn't used the language before:
  96.  
  97.     Title:            Tcl and the Tk Toolkit
  98.     Author:            John K. Ousterhout
  99.     Publisher:            Addison-Wesley
  100.     ISBN:            0-201-63337-X
  101.  
  102.     Title:            Practical Programming in Tcl and Tk
  103.     Author:            Brent Welch
  104.     Publisher:            Prentice Hall
  105.     ISBN:            0-13-182007-9
  106.  
  107. The "doc" subdirectory contains reference in documentation in
  108. in the "man" format found on most UNIX machines.  Unfortunantly,
  109. there is not a suitable way to view these pages on the Macintosh.  
  110. A version suitable for viewing on the Macintosh has yet to be
  111. developed.  We are working are having better documentation for
  112. the Macintosh platform in the future.  However, if you have WWW 
  113. access you may access the Man pages at the following URL:
  114.  
  115.     http://www.smli.com/research/tcl/man/
  116.  
  117. Other documentation and sample Tcl scripts can be found at
  118. the Tcl ftp site: 
  119.  
  120.     ftp://ftp.aud.alcatel.com/tcl/
  121.  
  122. The internet news group comp.lang.tcl is also a valuable
  123. source of information about Tcl.  A mailing list is also
  124. available (see below).
  125.  
  126. 5. Compiling Tcl
  127. ----------------
  128.  
  129. In order to compile Macintosh Tcl you must have the 
  130. following items:
  131.  
  132.     CodeWarrior release 7 or higher
  133.     Mac Tcl 7.5 (source)
  134.     CWGUSI 1.6.4 or higher
  135.     More Files 1.4.1
  136.  
  137. The project  files included with the Mac Tcl source should work 
  138. fine.  The only thing you may need to update are the access paths.
  139.  
  140. 6. Test suite
  141. -------------
  142.  
  143. The Macintosh version of Tk does not pass many of the tests in the
  144. test suite.  This is primarily due to dependencies in the test suite
  145. on the size of particular X fonts, and other X related features.  We
  146. will be working to develop a more general test suite for Tk under the
  147. Macintosh, but for now, you will not be able to pass many of the
  148. tests.  It is, however, much better than the alpha release!
  149.  
  150.  
  151. 6. Macintosh Tcl Mailing List
  152. -----------------------------
  153.  
  154. A Mailing List has been set up to discuss Macintosh related Tcl & Tk
  155. issues including (but not limited to) MacTcl & the Tk port.  In order
  156. to use this Mailing List you must have access to the internet.  If you
  157. have access to the WWW the home page for this mailing list is located
  158. at the following URL:
  159.  
  160.     http://www.smli.com/research/tcl/lists/mactcl-list.html
  161.  
  162. The home page contains information about the list and an HTML archive
  163. of all the past messages on the list.  To subscribe send a message to:
  164.     
  165.     listserv@sunlabs.sun.com
  166.     
  167. In the body of the message (the subject will be ignored) put:
  168.     
  169.     subscribe mactcl Joe Blow
  170.     
  171. Replacing Joe Blow with your real name, of course.  If you would just
  172. like to receive more information about the list without subscribing
  173. but the line:
  174.  
  175.     information mactcl
  176.     
  177. in the body instead.
  178.  
  179.  
  180.  
  181. If you have comments or Bug reports send them to:
  182. Ray Johnson
  183. rjohnson@eng.sun.com
  184.